home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / uniterm.zoo / readme_v.20c < prev    next >
Text File  |  1990-04-06  |  11KB  |  367 lines
  1. ReadMe for UniTerm V2.0c 016 <-| 
  2. ----------------------------   |
  3. 5.5.88                         |This number is displayed on the 
  4.                                 'About UniTerm...' dialog box and 
  5.                                 indicates the "Edit Number"
  6.  
  7. Changes 2.0b to 2.0c
  8. --------------------
  9.  
  10. General: A lot of the oldest code in UniTerm has been redone. Some things
  11.          should be even faster now.
  12.       
  13.          The 20ATO20C.TOS program will convert 2.0a/2.0b setup files
  14.          to 2.0c format, remote commands will be disabled, clipboard
  15.          size set to 2kB and NRC to ASCII (turned off).
  16.  
  17.          The delay time parameter now additionaly affects:
  18.  
  19.              start/end of transfer strings in ASCII file upload 
  20.              the dialer
  21.              macro processor send command
  22.              single-line editor.
  23.  
  24.          Keys moved: View History buffer (NEW!): <Alternate><V>
  25.             
  26.                      History Control:            <Alternate><S>
  27.  
  28.          Mouse cursor control now uses a double click with the
  29.          left button.
  30.  
  31.          UniTerm will no longer let you exit from the `Help' menu
  32.          if you still have desk accessory windows open. The deeper
  33.          reason for this is a AES deficiency.
  34.  
  35. Terminal Emulation:
  36.                      
  37.          NRC character sets implemented, they will naturally be
  38.          slower than the straight ASCII mode (the Dutch and 
  39.          Portugese sets are not completly implemented).
  40.  
  41.          I'm too lazy to list the corresponding escape sequences,
  42.          will be in the manual.
  43.  
  44.          NRC mode can also be set in the 'Terminal 2' dialog,
  45.          selecting [ASCII] just turns NRC mode off, selecting
  46.          one off the NRC sets, map the set into G0 and G0 into GL.
  47.  
  48.  
  49. *********************************
  50. *Macro processor: COMPLETLY NEW!*
  51. *********************************
  52.  
  53. The two modi (function key - macro file) are now more different, the % 
  54. command introducer is now only needed (and allowed!) on the function keys.
  55.  
  56. No more absolute line numbers (labels instead), additional integer and
  57. string variables.
  58.  
  59. No more boolean constants, use 0 and 1 intstead (for FALSE / TRUE)
  60.  
  61. Commands are no longer case sensitive.
  62.  
  63. Common features:
  64. ----------------
  65.  
  66.    Built-in functions:
  67.    -------------------
  68.  
  69.          add(int1,int2)      returns sum of int1 and int2.
  70.  
  71.          and(int1,int2)      returns logical 'and' of int1 and int2.
  72.  
  73.          assert()            asserts DTR.
  74.  
  75.          break(len,drop-dtr) send a break for len mS, drop DTR if
  76.                              if drop-dtr is true (<>0).
  77.  
  78.          concat(str1,str2)   concatenate str1 and str2 and return
  79.                              the result in $TEMP.
  80.  
  81.          copy(nr,str)        copy str into string variable nr (1 to 10).
  82.  
  83.          compare(str1,str2)  compare str1 to str2, return true if equal.
  84.  
  85.          drop()              drop DTR.
  86.  
  87.          dial(nr)            dial number nr (1 to 10), returns true if
  88.                              sucessful
  89.  
  90.          echo(str)           echo str to the screen.
  91.  
  92.          fileselector(path,filename,prompt)
  93.                              show a fileselector with path, filename and
  94.                              a prompt, returns true if [OK] is selected,
  95.                              $PATH and $FILENAME hold the values the user
  96.                              entered.
  97.          
  98.          get(instr,time)     wait for string instr, timeout after time
  99.                              seconds, returns true if sucessful.
  100.  
  101.          hangup()            hangup the modem.
  102.  
  103.          history(mode)       turn history saving on/off (1/0 for mode)
  104.  
  105.          inline(mode)        reads a line from the keyboard (until <Return>
  106.                              is pressed or a maximum of 80 characters are
  107.                              read (^C aborts)), if mode is true the characters
  108.                              are echoed, the line is returned in $TEMP.
  109.  
  110.          input(prompt)       prompt for a line of input, result is in $TEMP,
  111.                              returns true if [OK] is selected.
  112.  
  113.          kermit(mode,8-bit-mode,filespec)
  114.                              start Kermit filetransfer with:
  115.                              mode (string):   'SEND', 'REC' or 'GET'
  116.                              8-bit-mode: 1=true,0=false
  117.                              filespec: string with wildcards.
  118.  
  119.          loadsetup(name)     load a setup file. 
  120.  
  121.          loadtel(name)       load a dialer setup file
  122.  
  123.          message(str)        display str on the statusline, '' restores
  124.                              the normal statusline.
  125.  
  126.          macro(name)         execute macro file, returns value of exit
  127.                              function or:
  128.                                 -3 : syntax error (line in $TEMP)
  129.                                 -2 : not enough stack (macro files nested
  130.                                      more than one level)  
  131.                                 -1 : macro buffer full (max. 4096 bytes).
  132.        
  133.          or(int1,int2)       return logical 'or' of int1 and int2.
  134.         
  135.          path(str)           set GEMDOS path to str.
  136.  
  137.          popup(entry,command,name)
  138.                              redefine a popup menu entry
  139.  
  140.          run(name,commandline)
  141.                              run a program, returns the return code
  142.                              (negativ numbers display an alert box)
  143.  
  144.          reassign(alt-key,command)
  145.                              reassign the function of a 'Alt' key.
  146.  
  147.          suspend()           displays 'Press any key...' and waits
  148.                              for a keypress.
  149.  
  150.          send(str)           sends str.
  151.  
  152.          set(nr,int)         sets integer variable nr (1 to 10) to int.
  153.  
  154.          wait(int)           wait for int mS * 100
  155.  
  156.          unicommand(nr)      execute a UniTerm internal command.
  157.  
  158.          xmodem(mode,file)   start xmodem with:
  159.                              mode: 'SEND' or 'REC'
  160.                           
  161.          ymodem(mode,filespec) 
  162.                              start ymodem with:
  163.                              mode: 'SEND' or 'REC'  
  164.  
  165.                                               
  166.    Prefix operators (work only before arguments):
  167.    ----------------
  168.  
  169.       -  negate integer value
  170.       
  171.       !  logical not
  172.  
  173.       "  return integer as string
  174.  
  175.       .  return string as integer
  176.  
  177.    (. and " don't know about negative integers!)
  178.  
  179.    
  180.    String constants
  181.    ----------------
  182.  
  183.    Enclosed in single quotes, escape character '\', every character
  184.    after '\' equals itsself except:
  185.  
  186.       r    : \r is carrige return (ASCII 13)
  187.       n    : \n is newline (ASCII 10)
  188.       0xx  : \0xx is the octal ASCII value 0xx
  189.  
  190.    Predefined string variables:
  191.    ----------------------------
  192.  
  193.    $T ($TEMP) : used for return values of some built-in functions
  194.   
  195.    $F ($FILENAME) : see fileselector command
  196.    $P ($PATH)     :           "
  197.  
  198.    $C ($CURRENT) : current GEMDOS path
  199.  
  200.    $V ($VAR) : contains the address of UniTerm's parameter block
  201.  
  202.    String variables:
  203.    -----------------
  204.  
  205.    $1 to $10   max. 80 characters
  206.  
  207.    Integer variables:
  208.    ------------------
  209.  
  210.    @1 to @10  signed 16 bit value
  211.  
  212.  
  213. Additional features in macro file mode:
  214. ---------------------------------------
  215.  
  216.    Labels:
  217.    -------
  218.  
  219.    :1 to :20  (must be first and only word on a line!)
  220.  
  221.    Comments:
  222.    ---------
  223.  
  224.    A line starting with # is ignored on input.
  225.  
  226.    Additional statements
  227.    ---------------------
  228.  
  229.       if(int)     execute the rest of the line if int is <> 0
  230.  
  231.       jump(nr)    goto label number nr
  232.  
  233.       exit(int)   stop processing and return with value int
  234.  
  235.       call(nr)    execute subroutine at label nr (subroutines can't be 
  236.                   nested!)
  237.  
  238.       return()    return from subroutine
  239.  
  240.  
  241. *****************************************
  242. * History buffer viewing                *
  243. *****************************************
  244.  
  245. Needs at least 25kB of reserved system memory.
  246. Start with <Alternate><V>.
  247.  
  248. <ClrHom